home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / hangman1.zip / HANGMAN.DOC < prev    next >
Text File  |  1993-02-25  |  10KB  |  303 lines
  1.             ██████ ██████ ████████████ ██████ █████
  2.             ██████ ██████ ████████████ ██████ █████
  3.             █████████████ █████■██████ █████ ██████
  4.             █████████████ █████ ██████ █████ ██████
  5.  
  6.        ██████ █████ ████ ██████ ██   ██ █████ █████ ████
  7.        ▀▀▀▄▄▄ ██ ██ ██■    ██   ██ █ ██ ██■██ ██▄▄█ ██■
  8.        ██████ █████ ██     ██   ███████ ██ ██ ██ █▄ ████
  9.  
  10.                   Written By Steve Martinez
  11.                   Up All Night BBS, Chicago
  12.                  312-646-6615 USR/Dual 57600 
  13.             Copyright(C) 1991-1993 by UAN Software
  14.  
  15.                   HANGMAN.EXE Version 1.0
  16.                  Written by Steve Martinez
  17.             Copyright(C) 1993 by UAN Software
  18.  
  19.  
  20. WHAT DOES IT DO?
  21. ----------------
  22. HANGMAN.EXE is a door game where the player tries to solve the word
  23. puzzle by guessing letters. The player can only miss seven time
  24. before the Sysop is hung. Each wrong guess will cause a part of the
  25. sysop to display. This program can be configured to allow a limit
  26. of plays per day. 
  27.  
  28.  
  29. WILL IT WORK FOR YOU?
  30. ---------------------
  31. HANGMAN.EXE can run on any of the following BBS types:
  32.  
  33. PCBoard 14.x, Wildcat (Prior to v3.0), Wildcat v3.x+, GT Power,
  34. QBBS, RBBS, RA, Spitfire 3.x, TriBBS, and any BBS using DOOR.SYS.
  35.  
  36. See CONFIGURATION for more information on how run HANGMAN.EXE under
  37. these program types. 
  38.  
  39.  
  40. SHAREWARE
  41. ---------
  42. This program is SHAREWARE and must be registered with Steve
  43. Martinez. You are allowed to run this program for 30 days to see if
  44. it suits your BBS. After that 30 days you MUST send in the
  45. registration form and registration fee or STOP using it. When you
  46. register, you will receive a REGISTERED copy with your name and BBS
  47. name displayed. You will also get SUPPORT from UAN Software and UP
  48. All NIGHT BBS. You will be able to get free UPGRADE as they come
  49. out. This does not include postage, but you can download them free
  50. from UP ALL NIGHT BBS. You can save yourself a few $$$ by
  51. downloading your registered copy form Up All Night BBS. If you like
  52. a copy mailed to you. You will have to add postage and handling.
  53. See REGISTRATION for more information.
  54.  
  55. HANGMAN Manual - Page 2
  56.  
  57.  
  58. QUICK START!
  59. ------------
  60. Most people, including myself, don't like to read DOC file or
  61. Manuals. We just unzip the program, scan over the DOCs and run the
  62. program. So here is the quickest was to get this program running. 
  63.  
  64. 1. Place HANGMAN.EXE and it's files into it's own Directory.
  65.  
  66. 2. Use your text editor to EDIT the file called "HANGMAN" to suit 
  67.    your BBS needs. This file is the sample BAT file that will run 
  68.    HANGMAN.EXE. PCBoard types will use this file some others will 
  69.    need to add the information to the BAT file that calls your    
  70.    DOORS.
  71.    
  72.    PCBOARD EXAMPLE:
  73.    
  74.    CD\DOORS\HANGMAN
  75.    HANGMAN HANGMAN.CFG
  76.    CD %PCBDIR%
  77.    BOARD
  78.    
  79.    SPITFIRE SF.BAT EXAMPLE:
  80.   
  81.    :DOOR_H
  82.    REM Place Door H Commands Here
  83.    CD\SF\HANGMAN
  84.    HANGMAN HANGMAN.CFG
  85.    CD\SF   
  86.    GOTO LOOP
  87.  
  88. 3. Use your text editor to EDIT the file called "HANGMAN.CFG". 
  89.    
  90.    Line #1 is the path and file name of your BBS Door data file   
  91.    that is created when entering a door. See CONFIGURATION for    
  92.    types allowed.
  93.  
  94.    LINE #2 is your BBS Name.
  95.  
  96.    LINE #3 is the Sysops First Name.
  97.  
  98.    LINE #4 is the Sysops Last Name.     
  99.      
  100.    LINE #5 is Allowed plays per day. (Shareware MAX. is 5)
  101.  
  102. 4. Log on your board and see if it worked. 
  103.  
  104. 5. Send in the registration! 
  105.  
  106. If you have any problems setting this up. You might have to read
  107. the rest of this DOC.
  108.  
  109. HANGMAN Manual - Page #3
  110.  
  111.  
  112. SET UP & CONFIGURATION!
  113. -----------------------
  114. First thing you need to do is set up a /HANGMAN directory and copy
  115. all the HANGMAN files into it.
  116.  
  117. Next, uses your text editor and edit the file called "HANGMAN.CFG".
  118. This file is needed to tell HANGMAN who, what, where, etc. about
  119. you and your BBS.
  120.  
  121. The following are examples of formats that can be used in line #1
  122. of the configuration file. The paths may very, but the file names
  123. are the only data files that can be used.
  124.  
  125. C:\PCB\PCBOARD.SYS   <- For PCBoard systems using PCBoard.SYS only
  126. C:\PCB\USERS.SYS     <- For PCBoard systems using USERS.SYS.
  127. C:\BBS\CALLINFO.BBS  <- For Wildcat! systems (prior to v3.0).
  128. C:\BBS\CHAIN.TXT     <- For WWIV systems.
  129. C:\BBS\GTUSER.BBS    <- For GT Power systems.
  130. C:\BBS\USERINFO.DAT  <- For Wildcat! 3.x+ systems.
  131. C:\BBS\DOOR.SYS      <- For Any system that supports DOOR.SYS.
  132. C:\BBS\DORINFOx.DEF  <- For QBBS/RBBS/RA. Replace x with node #.
  133. C:\SF\SFDOORS.DAT    <- For Spitfire systems.
  134. C:\BBS\TRIBBS.SYS    <- For TriBBS systems.
  135.  
  136. Line #2              <- BBS Name.
  137. Line #3              <- Sysop's first name.
  138. Line #4              <- Sysop's last name.
  139. Line #5  (1 - 100)   <- Puzzles allowed per day. (Shareware MAX. 5) 
  140.  
  141.  
  142. NOTE: When using GTUSERS.BBS ONLY!
  143.  
  144. Line #5              <- Com Port
  145. Line #6              <- Node Number
  146. Line #7  (1 - 100)   <- Puzzles allowed per day. (Shareware MAX. 5)
  147.  
  148. Here's how my file looks:
  149.  
  150. C:\PCB\NODE%PCBNODE%\PCBOARD.SYS   <- The name & path of data file
  151. Up All Night BBS                   <- BBS Name 
  152. Steve                              <- My first name
  153. Martinez                           <- My last name
  154. 5                                  <- Allowed puzzles per day    
  155.  
  156. Notice the %PCBNODE% in the first line. The configuration file
  157. allows environment variable. See ENVIRONMENT VARIABLE for more
  158. information.
  159.  
  160.  
  161.  
  162.  
  163. HANGMAN Manual - Page #4
  164.  
  165.  
  166. SETTING UP BAT FILE
  167. ------------------- 
  168. Use your text editor to EDIT the file called "HANGMAN" to suit your
  169. BBS needs. This file is the sample BAT file that will run
  170. HANGMAN.EXE. PCBoard types will use this file. Some others will
  171. need to add the information to the BAT file that calls your DOORS.
  172.  
  173.    PCBoard EXAMPLE:
  174.    
  175.    CD\DOORS\HANGMAN
  176.    HANGMAN HANGMAN.CFG
  177.    CD %PCBDIR%
  178.    BOARD
  179.    
  180.    SPITFIRE SF.BAT EXAMPLE:
  181.   
  182.    :DOOR_H
  183.    REM Place Door H Commands Here
  184.    CD\SF\HANGMAN
  185.    HANGMAN HANGMAN.CFG
  186.    CD\SF   
  187.    GOTO LOOP
  188.  
  189. BAT FILE EXPLAINED:
  190. -------------------
  191. Very simple. First change the directory to the HANGMAN directory.
  192. Next, call HANGMAN with the CONFIGURATION FILE. After the program
  193. is finished, change the directory back to your BBS directory.
  194.  
  195. Notice the %PCBDIR% in the PCBoard example. See ENVIRONMENT
  196. VARIABLE for more information.
  197.  
  198.  
  199. NOTE ON HIGH SCORE BULLETINS
  200. ----------------------------
  201. The bulletins generated by HANGMAN.EXE can be changed by editing
  202. the first line of the file called "HANGMAN.BUL" which will be
  203. created after the first time HANGMAN is played. The default is
  204. HANGMAN.BLT for non-color graphics and HANGMANG.BLT for color
  205. Graphics. Your BULLETIN name can NOT be longer that 7 letter
  206. because the color file name will have a "G" appended to it. You may
  207. add the path name along with the file name to this line. My first
  208. line in HANGMAN.BUL looks like this: BLT1. That means the non-color
  209. will be "BLT1" and the color will be "BLT1G". Remember, the "G"
  210. will be appended to the FIRST name of the file, so use ONLY 7
  211. letter in the first name.
  212.  
  213.  
  214.  
  215.  
  216.  
  217. HANGMAN Manual - Page #5 
  218.  
  219.  
  220. Fossil Driver Support
  221. ---------------------
  222. DoorFrame supports the use of Fossil drivers.  To tell your Door to
  223. use the Fossil driver instead of the standard COM ports, just put
  224. /FD on the command line when running the door. 
  225.  
  226. For example:
  227.  
  228.      HANGMAN HANGMAN.CFG /FD
  229.  
  230. /FD indicates that a Fossil driver is present and should be used.
  231. If no Fossil driver is detected, DoorFrame will print a message to
  232. that effect and exit the door gracefully.
  233.  
  234. Environment Variables
  235. ---------------------
  236. DoorFrame supports COM 1-4 on the standard IRQ's - COM1/COM3 = IRQ4
  237. and COM2/COM4 = IRQ3. If you wish to use a non-standard IRQ, add
  238. the IRQ number after the configuration filename. Let's assume your
  239. Door is called HANGMAN and you want to use COM1 and IRQ5. The
  240. command line passed to your Door would be:
  241.  
  242.     HANGMAN HANGMAN.CFG /5  or
  243.     HANGMAN HANGMAN.CFG /%IRQ%  for the environment variable.
  244.  
  245. The /5 tells DoorFrame to use IRQ5 rather than the standard IRQ4
  246. that is normally used with COM1. No /x parameter is needed for the
  247. standard IRQ's.
  248.  
  249. When specifying the location of the system file on line 1 of the
  250. doors .CFG file, you may use the environment variables %pcbdrive%,
  251. %pcbdir%, %pcbnode%, and %wcnodeid%. Some examples:
  252.   
  253. PCBoard: 
  254. C:\PCB\USERS.SYS       = %pcbdrive%%pcbdir%\USERS.SYS
  255. C:\PCB\NODE1\USERS.SYS = %pcbdrive%%pcbdir%\NODE%pcbnode%\USERS.SYS
  256.  
  257. Wildcat!:
  258. USERINFO.DAT in C:\WC\NODE1   - C:\WC\NODE%wcnodeid%
  259.  
  260. Non-PCBoard systems may use the PCB environment variables by
  261. setting them in either AUTOEXEC.BAT or in the batch that runs the
  262. door. 
  263.  
  264. For example:
  265.  
  266. SET PCBDRIVE=C:
  267. SET PCBDIR=\BBSDIR
  268. SET PCBNODE=1
  269.  
  270.  
  271.  
  272. HANGMAN Manual - Page #6
  273.  
  274.  
  275. REGISTRATION
  276. ------------
  277. HANGMAN cost $10 to register plus $3 postage and handling. You may
  278. download HANGMAN from Up All Night BBS to avoid the postage and
  279. handling charge. You need to fill out the registration form called
  280. "HANGMAN.REG" and mail it in. 
  281.  
  282. EXTRA
  283. -----
  284. Although HANGMAN comes with a 100 puzzle GENERAL word file. You can
  285. call Up All Night BBS at anytime for add-on Puzzle File. Download
  286. these and copy them over the file in the HANGMAN directory.
  287.  
  288.  
  289.  
  290. ALL DONE!
  291. ---------
  292. Now you are finished! So, Boot up that Board and check it out! If
  293. you have any problems or have any question, feel free to call Up
  294. All Night BBS and leave a Comment To Sysop. HANGMMAN supports
  295. Multi-Node BBS's. If you run a Multi Node BBS, PLEASE contact me
  296. and let me know how it's working. If you have any suggestion you
  297. can call me at (312-646-6616 2400bps) or (312-646-6615 57600bps). 
  298.  
  299.  
  300.  
  301. THANK YOU FOR DOWNLOADING THIS FILE! PLEASE SUPPORT SHAREWARE!
  302.  
  303.